home *** CD-ROM | disk | FTP | other *** search
/ QRZ! Ham Radio 4 / QRZ Ham Radio Callsign Database - Volume 4.iso / files / arrl / faq / faqappl1.txt < prev    next >
Internet Message Format  |  1994-11-27  |  33KB

  1. From: dmag@caen.engin.umich.edu (Dan DeMaggio)
  2. Newsgroups: comp.sys.apple2,news.answers
  3. Subject: comp.sys.apple2 - Frequently Asked Questions (and answers) part 1 of 2
  4. Supersedes: <a1_760168695@caen.engin.umich.edu>
  5. Followup-To: comp.sys.apple2
  6. Date: 2 Mar 1994 05:25:11 GMT
  7. Organization: University of Michigan Engineering, Ann Arbor
  8. Lines: 692
  9. Approved: news-answers-request@MIT.Edu
  10. Distribution: world
  11. Expires: 5 Apr 1994 05:25:02 GMT
  12. Message-ID: <a1_762585902@caen.engin.umich.edu>
  13. Reply-To: dmag@umich.edu
  14. NNTP-Posting-Host: sc.engin.umich.edu
  15. Summary: What you need to know about the comp.sys.apple2 newsgroups
  16. Originator: dmag@sc.engin.umich.edu
  17.  
  18. Archive-name: apple2/part1
  19. Last-modified: 30 Jan 1994
  20. Version: 3.5
  21.  
  22.  
  23. ----------------------------------------------------------------------
  24.  
  25. Date: 1/1/93
  26. From: dmag@umich.edu
  27. Subject: The FAQ (Frequently Asked Questions) post
  28.  
  29.  
  30.  Hi! Welcome to the comp.sys.apple2 newsgroup!
  31.  
  32.  This article contains the answers to some Frequently Asked Questions (FAQ)
  33.  often seen in comp.sys.apple2. I am posting this article (once every three
  34.  weeks or so--but once a week in September) to help reduce the volume in this
  35.  newsgroup and to provide hard-to-find information of general interest.
  36.  
  37.  I hope it answers some of your questions. If you have other questions, feel
  38.  free to e-mail me.
  39.      Dan DeMaggio (dmag@umich.edu)
  40.  
  41.  P.S. On a suggestion, I've converted this to the news archive format (I
  42.  think).
  43.  
  44.         Table of contents
  45.         -----------------
  46. Part I: The Net
  47.  How do I get to comp.sys.apple2 and what is it?
  48.  How do I get files from the net?
  49.  What are the Anonymous FTP sites for Apple II software?
  50.  What archivers do I need to know about?
  51.  What do these file extensions mean?
  52.  How do I tell what kind of file I have?
  53.  
  54. Part II: Apple stuff
  55.  What is an Apple II?                 (common configurations and additions)
  56.  Frequently Asked Questions   (IBM+HFS disks, HD drives, computer versions)
  57.  GS System 6.0 Notes                                     (from the experts)
  58.  What the Apple II can do                 (ideas for adding to your system)
  59.  Apple II resources                              (Places supporting the II)
  60.  troubleshooting           (90% of problems can be solved with these hints)
  61.  SCSI Notes                                    (Notes on dealing with SCSI)
  62.  
  63.  
  64.  New items are marked with:
  65. ---- NEW OR CHANGED
  66.  
  67.  
  68.  FTP-able items are marked like this:
  69. FTP:  apple2.archive.umich.edu /apple2/faq/faq1.txt
  70.  
  71.  Note that the apple2.archive.umich.edu site is often loaded down, so see the
  72.  section on FTP for other sites, including mirrors of umich.
  73.  
  74. ------------------------------
  75.  
  76. Date: 8/8/93
  77. From: dmag@umich.edu
  78. Subject:  How do I get to comp.sys.apple2 and what is it?
  79.  
  80. ---- NEW OR CHANGED
  81.  
  82.  
  83.  The comp.*.apple2.* groups were created for the discussion of the Apple II
  84.  series of computers. They provide a forum for interested people to compare
  85.  notes, ask questions, and share insights about Apple IIs. Currently, these
  86.  groups include:
  87.  
  88. comp.sys.apple2              - General discussion and questions
  89.                                relating to all Apple //'s
  90. comp.sys.apple2.comm         - Communications and networking related
  91.                                issues
  92. comp.sys.apple2.gno          - Discussion of program GNO/ME for the
  93.                                Apple IIGS (UNIX for the Apple IIGS)
  94. comp.sys.apple2.marketplace  - Buying, selling and promoting Apple //
  95.                                related products
  96. comp.sys.apple2.programmer   - Discussion relating to any aspect of
  97.                                programming the Apple //
  98. comp.sys.apple2.usergroups   - Discussion relating to Apple //
  99.                                usergroups
  100. comp.binaries.apple2         - Public Domain/Shareware Software for all
  101.                                Apple //'s
  102. comp.sources.apple2          - A moderated newsgroup for the posting of
  103.                                Apple // related source code
  104. alt.emulators.ibmpc.apple2   - Discussion relating to the use of Apple //
  105.                                emulation software/hardware on an IBM
  106.                                compatible system
  107.  
  108.  
  109.  Each message gets passed on to tens of thousands of systems around the world,
  110.  so please do not cross-post unnecessarialy. Also, please be nice. New users
  111.  should check out news.answers new user's post.
  112.  
  113.  There are three ways to access these groups:
  114.  
  115.  1) via USENET, with a news-reader program.
  116.  
  117.  2) via a ProLine BBS.
  118.  
  119.  3) via INFO-APPLE, a bi-directional e-mail gateway maintained by Apple
  120.  Computer.
  121.  
  122. For this:                        Send a message body of "help" to:
  123. ---------------------------      ---------------------------------
  124. Subscribe to INFO-APPLE          info-apple-request@apple.com
  125.   (Alternate address)            LISTSERV@vm1.nodak.edu
  126.   (BITNET address of above)      LISTSERV@NDSUVM
  127. APPLE2-L archives                LISTSERV@brownvm.brown.edu
  128.   (BITNET address of above)      LISTSERV@BROWNVM
  129. Games from APPLE2-L              LISTSERV@utarlvm1.uta.edu
  130.   (BITNET address of above)      LISTSERV@UTARLVM1
  131. More files via E-Mail            archive-server@plains.nodak.edu
  132.   (BITNET address of above)      FILESERV@PLAINS
  133. Kermit file tranfer program      KERMSRV@cuvmb.cc.columbia.edu
  134.   (BITNET address of above)      KERMSRV@CUVMA (BITNET)
  135. Apple /// files                  APPLE3-L@WVNVM.WVNET.EDU
  136. To post your message all over the world, use these addresses: (PLEASE
  137. do not post general requests for help here.  Use the addresses
  138. above to subscribe and unsubscribe.
  139.  
  140. Post to comp.sys.apple2          info-apple@apple.com OR
  141.                                  comp-sys-apple2@ucbvax.berkeley.edu
  142. Post a BSQ file                  comp-binaries-apple2@ucbvax.berkeley.edu
  143. Post AAF source                  comp-sources-apple2@ucbvax.berkeley.edu
  144.  
  145.  
  146.  Comp.binaries.apple2 is a newsgroup used to distribute public domain,
  147.  freeware, and shareware Apple II software (executables, pictures, sounds,
  148.  etc...). Software distributed on comp.binaries.apple2 is expected to be a
  149.  BinSCII text file of ShrinkIt archives. [See later in the FAQ for information
  150.  on getting these programs.] ALWAYS include text in the first message that
  151.  describes what is in the BSQ file. Include such things as what type of
  152.  computer it runs on and what it does.
  153.  
  154.  [Public Domain programs may be used and copyied freely. FreeWare is the same,
  155.  except that the origninal owner retains the Copyright. ShareWare programs can
  156.  be distributed freely, and tried out for free, but if you use it a lot, you
  157.  are expected to help pay for it.]
  158.  
  159.  Comp.sources.apple2 is a newsgroup used to distribute public domain,
  160.  freeware, and shareware Apple II source code. The posts in
  161.  comp.sources.apple2 should be in Apple Archive Format. Contact
  162.  jac@paul.rutgers.edu for details.
  163.  
  164.  Discussions concerning the software posted in these groups, or the methods of
  165.  locating, decoding, or accessing this software, or questions on locating
  166.  archive sites of this software, or any OTHER discussions are to be held in
  167.  comp.sys.apple2. If someone DOES either intentionally or accidentally post to
  168.  these groups, please respond only in Email - do not compound the problem!
  169.      Note: Distributing commercial software on the net is a crime - just don't
  170.  do it!
  171.  
  172. ------------------------------
  173.  
  174. Date: 1/29/94
  175. From: dmag@umich.edu
  176. Subject: How do I get files off the net?
  177.  
  178. ---- NEW OR CHANGED
  179.  
  180.  
  181. Quick Summary:
  182. Step 1: Make a list of files that you want
  183. Step 2: Get files to your host (a UNIX box or ProLine BBS)
  184. Step 3: Get files to your Apple II
  185. Step 4: Create BINSCII
  186. Step 5: Create ShrinkIt
  187. Step 6: Use BinSCII & Shrinkit to create Shrinkit GS
  188. Step 7: Extract the files you _REALLY_ wanted
  189.  
  190. Step 1: Make a list of files that you want
  191. 1) You need BINSCII (binscii.exe) and ShrinkIt (shrinkit.3.3.exe.bsc)
  192.    unless you already have them, or know someone who has them.
  193. 2) If you have a GS (and use GS/OS), you will want Shrinkit GS
  194.    (shrinkit.gs.exe) and GSCII (gscii.bsc)
  195. 3) Add any other files you want. Don't try to get everything the
  196.    first time around.  Try one or two test files for starters.
  197.  
  198.   Note: Filenames will vary from site to site. Shrinkit and Binscii
  199.         are usually avaliable on all the Apple II FTP sites.
  200.  
  201. Step 2a: Get files to your host (For ProLine users)
  202. 1) Dial up your host and log in.
  203. 2) I'm not familiar with ProLine, so I'll be vauge here. Just go
  204.    into the files section and look...
  205.  
  206.  
  207. Step 2b: Get files to your host (For UNIX, using FTP)
  208. 1) Choose an FTP site from the FAQ
  209. 2) At your UNIX prompt, type "ftp ______" (fill in site name)
  210. 3) At the "Login:" prompt, type "anonymous"s
  211. 4) Type in your e-mail address
  212. 5) Type "bin"
  213. 6) use "cd ____" to get to where the Apple II files are
  214. 7) Locate each file (more "cd ___"'s and "ls" (list files). Also,
  215.    "cd .." will move up a directory.)
  216. 8) use "get ______" to get it
  217. 9) When you are done using FTP, type "quit"
  218. 10) Advanced users may want to run uudecode, uncompress, tar, SciiBin,
  219.    or Nulib on the files before they download them.
  220.  
  221. Step 3: Get files to your Apple II
  222. 1) Find out what file transfer protocols your Apple communications
  223.    package supports. (see below for a list)
  224. 2) On your local comm program, set your file transfer type to Text
  225.    (TXT) or Binary (BIN) depending on what type of file you are
  226.    downloading. If there is an option to "strip incoming linefeeds",
  227.    try turning it on.
  228. 3) Get your host to send you the file.  I don't know about ProLine,
  229.    but UNIX users can use these commands:
  230.    For Z-Modem: "sz ___ ____ ____"  (file names)
  231.    For X-Modem: "sx ____" (one at a time)
  232.    For Kermit:  "kermit", then "put _____" (filename)
  233. 5) If needed, tell your local communications program to Receive. You
  234.    must do this quickly, or the other host will give up trying to
  235.    send the file.
  236. 4) Write down the full pathname of the files you downloaded and where
  237.    you put them. There will be a quiz later.  Pathnames look like
  238.    "/DISK/DIR/FILE.NAME"
  239.  
  240.   Note: If something goes wrong, hit ESC, Ctrl-X or Ctrl-C 3 times.
  241.         If you can't get one protocol to work, try the next one
  242.         down. Z-modem is much faster than the others. You will
  243.         want to find a program that supports it.
  244.  
  245. Step 4: Create BINSCII
  246. 1) After you disconnect, go into Applesoft by starting BASIC.SYSTEM
  247. 2) At the `]` prompt, type 'EXEC ____' (your BINSCII file name)
  248.   Note: If you get ?SYNTAX ERRORs then something went wrong. Try
  249.         looking at the file with a Text Editor.
  250. 3) Type "cat" and look for BINSCII (type 'SYS')
  251. 4) type "-BINSCII" or "-BINSCII.SYSTEM" depending on above
  252.  
  253.   Note: You should get the BINSCII opening screen.
  254.  
  255. Step 5: Create ShrinkIt
  256. 1) If your Shrinkit file ends in ".BSC" then (In BINSCII) type in
  257.    the filename of your ShrinkIt file
  258. 2) Quit BINSCII. Get into AppleSoft again.
  259. 3) Type "EXEC SHRINKIT3.3.XTX" (you may need the full pathname)
  260. 4) Run ShrinkIt with "-SHRINKIT.SYSTEM"
  261.  
  262. Step 6: Extracting everything else
  263. 1) If it's BSQ or BSC, run it through BINSCII
  264. 2) If BINSCII creates a ".SHK" file, or if you download a ".SHK"
  265.    file, then use ShrinkIt on the file.  It's easy to use and it
  266.    doesn't give you the dreaded "FILENAME QUIZ!"
  267.  
  268.  
  269.  For those who haven't picked a program to download with, here are the
  270.  biggies: When in doubt, buy ProTerm.
  271.  
  272. Program   Comp Emulations     Protocols             Note
  273. ------------------------------------------------------------------------------
  274. ProTerm    E$  PSE, VT-100     Kermit, X,Y,Z-modem  From InSync
  275. Kermit-65  E   VT-100          Kermit, X-modem      Hard to use,Works on ][+
  276. Z-Link     E   VT-100          X-modem              Good.
  277. CommSys    E   none            X-modem              Works on ][+
  278. TIC        E$  VT-52 (+)       X-modem              For hackers. From Q-Labs
  279. Agate      E   mono ANSI       X,(Y,Z rec'v only)   Unpacks ZIP, Buggy
  280. ColorTerm  GS  color ANSI      X-modem              Desktop based
  281. MegaTerm   GS  color ANSI      none                 ProDOS 8
  282. ANSITerm   GS$ color ANSI, PSE X,Y,Z-modem          Editor, scrollback, etc.
  283. SnowTerm   GS  VT-100 (+)      none                 Desktop based
  284. FreeTerm   GS  none            X-modem              Desktop based
  285. GenComm    GS  none            none                 Text, Shell Compat.
  286. GSVT       GS  VT-100          none                 Desktop
  287. GTerm      GS  color ANSI      none                 Written in BASIC/ML
  288. Telcom     GS  VT-100, PSE     X, (Y rec'v only)    Shell compat
  289. ----------Key:---------
  290. Key: $ = A commercial program
  291. Computer:  E = works on GS and //e, GS = only works on GS
  292.  
  293. See the resources section for where to buy the commercial programs.
  294.  
  295.  
  296.  All of the non-commercial programs are available on the different FTP sites.
  297.  If you don't have a comm program already, your best bet is to have someone
  298.  mail you one on a disk.
  299.     
  300.  
  301. ------------------------------
  302.  
  303. Date: 6/7/93
  304. From: dmag@umich.edu
  305. Subject: What are the big Anonymous FTP sites for Apple II software?
  306.  
  307.  
  308.  The following is a list of FTP sites with Apple // related files. See
  309.  elsewhere in this FAQ for details about using FTP.
  310.  
  311. apple2.archive.umich.edu    /archive/apple2  *
  312. info2.rus.uni-stuttgart.de  /afs/umich.edu/group/itd/archive
  313. archive.orst.edu            /pub/mirrors/archive.umich.edu  *
  314. brownvm.brown.edu           LISTSERV.193 (Note 1)
  315. cco.caltech.edu             /pub/apple2 (mostly GS stuff)
  316. f.ms.uky.edu                /pub/appleII
  317. grind.isca.uiowa.edu        /apple2  *
  318.                             /umich?
  319. plains.nodak.edu            /pub/apple2
  320. wuarchive.wustl.edu         /systems/apple2
  321.                             /usenet/comp.binaries.apple2
  322.                             /usenet/comp.sources.apple2
  323.                             /mirrors/archive.umich.edu/apple2
  324. ftp.uni-kl.de               /pub/apple2
  325. calvin.sfasu.edu         /pub/apple2 (HyperC, a few other things)
  326. cs.bu.edu                /PC/APPLE (a little bit of everything)
  327. ftp.apple.com            /dts/aii (sys software, tech notes)
  328. ftp.cc.utexas.edu        /gifstuff (some Apple GIF programs)
  329. ftp.hawaii.edu           /incoming/apple2 (a couple of games)
  330. iskut.ucs.ubc.ca         /pub/apple (Kermit, BinSCII, unshrinkit)
  331. pindarus.cs.uiuc.edu     /pub/apple2 (GNO utils and info)
  332. slab.slip.uiuc.edu       /apple2 (GScii, fonts, GS sys 6)
  333. ucrmath.ucr.edu          /PC/apple2 (LISA assembler)
  334.  
  335. Note 1: Files on brownvm.brown.edu are stored by serial number.  For a
  336. human-readable directory, send e-mail with the text "help" to
  337. listserv@brownvm.brown.edu.
  338.  
  339.  Items marked with a "*" can be also be accessed via 'gopher' if you have it.
  340.  
  341. Archives of comp.sources.apple2
  342. ===============================
  343. wuarchive.wustl.edu      /usenet/comp.sources.apple2 (complete!)
  344. cnam.cnam.fr             /pub/Archives/comp.sources.apple2 (incomplete)
  345. hp4nl.nluug.nl           /pub/newsarchive/comp/sources/apple2 (incomplete)
  346. mcsun.eu.net             /pub/newsarchive/comp/sources/apple2 (incomplete)
  347. nic.funet.fi             /pub/archive/comp.sources.apple2 (complete?)
  348.  
  349. Archives of comp.sys.apple2
  350. ===========================
  351. relay.cs.toronto.edu     /pub/lists.1989 (1989 only)
  352. wsmr-simtel20.army.mil   PD2:<ARCHIVES.APPLE> (1990 and 1991 only)
  353.  
  354. FTP:  watsun.cc.columbia.edu /kermit/a (the OFFICIAL source for Kermit)
  355.  
  356.  Non-USENET readers wanting files should look at the e-mail addresses in the
  357.  "What is comp.sys.apple2" section.
  358.  
  359. Subtopic:  Archie, the archive searcher
  360. ================================
  361.  
  362.  There is a program called archie that allows you to search many archives
  363.  quickly. Look for the program 'archie' or 'xarchie' at your site, or you can
  364.  telnet (login as archie) to:
  365.  
  366. archie.rutgers.edu   128.6.18.15   (Rutgers University)
  367. archie.unl.edu       129.93.1.14   (University of Nebraska in Lincoln)
  368. archie.ans.net       147.225.1.2   (ANS archie server)
  369. archie.mcgill.ca     132.206.2.3   (Canada server, original archie site)
  370. archie.au            139.130.4.6   (Australian server)
  371. archie.funet.fi      128.214.6.100 (European server in Finland)
  372. archie.doc.ic.ac.uk  146.169.11.3  (UK/England server)
  373. archie.cs.huji.ac.il 132.65.6.15   (Israel server)
  374. archie.wide.ad.jp    133.4.3.6     (Japanese server)
  375.  
  376.     
  377.  
  378. ------------------------------
  379.  
  380. Date: 1/1/93
  381. From: dmag@umich.edu
  382. Subject: What archivers do I need to know about?
  383.  
  384.  
  385. Subtopic:  BinSCII
  386. ================================
  387.  
  388.  BinScii converts binary files to text files and back. Binary files contain
  389.  pictures, computer programs, etc. Text files usually contain human readable
  390.  text (like this file), but a BinSCII file just looks like a jumble of letters
  391.  and symbols. A BinScii text file is larger than the original binary file.
  392.  Binscii is needed to transfer programs across the network when there is no
  393.  binary mode (like the Usenet newsgroups and e-mail).
  394.  
  395.  When turning a binary file into text, BinSCII will output a series of files.
  396.  Each file contains a segment of the original program encoded in BinSCII
  397.  format. These segments are small enough to be posted or e-mailed without
  398.  clogging the network. (Actually, they are usually posted 3 at a time to save
  399.  bandwidth).
  400.  
  401.  When re-creating a binary file from the BinScii segments, all one has to do
  402.  is collect ALL the segments and run them through BinScii. Each segment has a
  403.  header that tells BinScii which segment it is. BinScii is intelligent enough
  404.  to wade through all extraneous text (i.e. newsgroup headers, etc) and find
  405.  the segments. It does not matter what order the segments are in, and the
  406.  segments can be in different files. The only thing you have to remember is
  407.  that BinScii does not check to see if ALL of the segments have been accounted
  408.  for. If there are segments missing, the program will not work, or more likely
  409.  you will get a 'file corrupted' error when unshrinking.
  410. FTP:  apple2.archive.umich.edu /apple2/8bit/archivers/binscii.exe
  411.  
  412.  GS users can use GSCII+, an NDA version of Binscii. GSCII+ can also
  413.  encode/decode several other formats.
  414. FTP:  apple2.archive.umich.edu /apple2/gs/archivers/gscii.bsc
  415.      [ Note that most files on the network are NuFX archives that have been
  416.  BinSCII'ed so they can be posted. After running Binscii, you will still need
  417.  to run ShrinkIt on the resulting file.]
  418.  
  419.  For those of us on Unix boxes who are able to transfer binary files to our
  420.  Apple ][, SciiBin can reduce the time spend downloading. It is a decode-only
  421.  version of BinSCII written in C. The idea is that you compile this on your
  422.  Unix box, and run your BinScii files from comp.binaries.apple2 through it. It
  423.  will re-create the original (smaller) file. This works great if there is a
  424.  NuFX archive in the BinSCII file, but can cause problems if BinSCII was
  425.  applied directly to ProDos executable files. (Unix has no way of storing the
  426.  ProDos file type and aux type of a file, so they simply get lost. See the
  427.  section on filetypes.
  428. FTP:  wuarchive.wustl.edu /?
  429.  
  430.  If you need a Unix BinSCII encoder, Bsc will do the trick. The source code is
  431.  in "Apple archive format".
  432. FTP:  cco.caltech.edu /pub/apple2/source/bsc.aaf ?
  433. FTP:  apple2.archive.umich.edu /apple2/unix/bsc.aaf
  434.  
  435. Subtopic:  ShrinkIt and NuFX archives
  436. ================================
  437.  
  438.  ShrinkIt is an Apple II program which takes one or more Apple II ProDOS files
  439.  or disks and 'archives' them into a single file (called a NuFX archive). It
  440.  also stores all the vital ProDos information, such as filetype and auxtype.
  441.  Usually these files are denoted by putting a ".SHK" extension on the archive.
  442.  ShrinkIt can also shrink an entire disk into a file (extension ".SDK"), but
  443.  this is only used when the disk is not ProDos. ShrinkIt is also a menu driven
  444.  utility that compresses/extracts, but also formats disks, copies files, etc.
  445.  ShrinkIt can also extract programs with Binary II headers, and files in BLU
  446.  archives.
  447. FTP:  apple2.archive.umich.edu /apple2/8bit/archivers/shrinkit.3.3.exe.bsc
  448.  
  449.  GShk is a version of ShrinkIt for GS computers. This is even more of a wonder
  450.  utility in that it extracts many different archive types (Unix compress, PC
  451.  Arc, Mac StuffIt, Apple Single). Files encoded with GShk are usually smaller
  452.  than those encoded with ShrinkIt, but can still be extracted with ShrinkIt
  453.  (except files with resource forks).
  454.  
  455.  ShrinkIt+ and UnShrinkIt+ are programs for the Apple II+ that allow an Apple
  456.  II+ user to create NuFX archives and extract from them. Autounshrink is a
  457.  NuFX extractor that attempts to recover from errors within an NuFX file.
  458.  
  459. Subtopic:  Executioner
  460. ================================
  461.  
  462.  Executioner was the standard program previous to BinSCII for converting Apple
  463.  II files into text to be mailed/posted. It is no longer considered the
  464.  standard for most transferals of Apple II binary files. Presently,
  465.  Executioner is typically only used to distribute BinSCII. Some older files in
  466.  the various archives may also be encoded with this program. Many of them will
  467.  not work under ProDos.
  468.  
  469.  To translate an Executioner text file to an Apple II file required that you
  470.  delete the mail headers/trailers, translated the newlines into carriage
  471.  returns, download the file to your Apple II and from Applesoft Basic, type
  472.  the command 'EXEC <filename>' where <filename> is the name of the file you
  473.  downloaded.
  474.  
  475. Subtopic:  Apple Archive Format (aaf)
  476. ================================
  477.  
  478.  Apple Archive Format was invented as a standard way to post source code to
  479.  comp.sources.apple2. The C and Basic source code to aaf unpackers are
  480.  available on the various FTP sites, in aaf format. Fortunately, files in aaf
  481.  format can be turned back into source code with a simple text editor. Just
  482.  break the file up into component files and remove the first character of each
  483.  line.
  484. FTP:  apple2.archive.umich.edu /apple2/unix/*.aaf
  485.  
  486. Subtopic:  Net standard formats
  487. ================================
  488.  
  489.  There are several formats that are used widely on the Internet. The most
  490.  common in FTP sites are tar (.tar) and compress (.Z). To undo a Tape ARchive,
  491.  type 'tar -xvf filename.tar'. To undo a compress, type 'uncompress
  492.  filename.Z'. Since tar does not make the file smaller, and compress can only
  493.  compress 1 file, many times you will find files that are 'tarred an
  494.  feathered'. They have a '.tar.Z' extension. Just run uncompress then un-tar
  495.  the result.
  496.  
  497.  To distribute binaries on the net, most other groups use uuencode (c.b.a2
  498.  uses BinSCII). To return them to normal, type 'uudecode filename'. Note that
  499.  uuencoded things were not meant to be split up and posted, so when getting
  500.  multiple parts, you will have to paste them together and run them through
  501.  uudecode. (BinSCII is a lot smarter, that's why we use it on c.b.a2.) BinSCII
  502.  is better because 1) It stores the ProDos filetype, etc. 2) It splits the
  503.  file into 12K chunks, 3) It does a CRC checksum on each chunk.
  504.  
  505.  Most of these 'Unix' standard formats are available on the Apple. For
  506.  example, ShrinkIt GS will uncompress files, there is a uudecode for the //e,
  507.  and Tar is available as a GS shell executable.
  508. FTP:  apple2.archive.umich.edu /apple2/8bit/util/dearc.*
  509.  
  510. Subtopic:  A quick note about ProDos filetypes
  511. ================================
  512.  
  513.  ProDos keeps some information about a file's type. Files can be text (TXT),
  514.  binary (BIN), executable (SYS), fonts (FON), etc. Most other file systems do
  515.  not have a place to store this information, so it may get 'lost' when you
  516.  upload the file. Similarly, when you download a file, you may not know the
  517.  file type. Most comm programs will use some default. For NuFX archives, this
  518.  is not a big deal, since you can still unpack an archive if the filetype is
  519.  wrong (and the archive stores the filetype of the files inside the archive).
  520.  For other files, you may need to change the file's type. One utility I
  521.  recommend is File Attribute Zapper II.
  522. FTP:  apple2.archive.umich.edu /apple2/8bit/util/fazz.2.3.bsq
  523.  
  524. Program        Format   Author
  525. ---------------------------------------------------------------------------
  526. Nulib v3.21      C      Andy McFadden  (fadden@uts.amdahl.com)
  527. SciiBin v3.10    C      Marcel Mol, Dave Whitnet, Bruce Kahn
  528. Bsc v1.2         C      Neil Parker
  529. Executioner      A      Glen Bredon
  530. BinSCII v1.0.3   A      David Whitney  (davewh@microsoft.com)
  531. ShrinkIt v3.3    A      Andy Nicholas  (shrinkit@apple.com)
  532. (Un)ShrinkIt+    A      Andy Nicholas  (shrinkit@apple.com)
  533. AutoUnShrink     A      Andy Nicholas  (shrinkit@apple.com)
  534. GShk v1.1        G      Andy Nicholas  (shrinkit@apple.com)
  535. GSCII+ 2.3.1     G      Darek Taubert  (dat33228@uxa.cso.uiuc.edu)
  536.  
  537. Format:
  538.   C - Distributed as source code written in C.
  539.   A - Executable, runs on most Apple //s.
  540.   G - Executable, runs on GS only.
  541.  
  542.      |Type| NuFX | Bin  | uuen-| com-  |.ZOO | Bin | LZH/| Stuff| ARC | Other|
  543. Program | |      | SCII | code | press |     | Hex | LHA | -It  |     |      |
  544. --------|-|------|------|------|-------|-----|-----|-----|------|-----|------|
  545. Binscii |e|      |   X  |      |       |     |     |     |      |     |      |
  546. Shrinkit|e|   X  |      |      |       |     |     |     |      |     |      |
  547. DeArc   |e|      |      |      |       |     |     |     |      |  D  |      |
  548. Angel[1]|e|      |      |      |   X   |  X  |     |  X  |      |  X  | .ZIP |
  549. GShk    |g|   X  |      |      |   D   |  D  |     |     |  D   |  D  |      |
  550. GSCII+  |g|      |   X  |   X  |       |     |  D  |     |      |     | .AAF |
  551. sscii   |x|      |   X  |   X  |       |     |  X  |     |      |     |      |
  552. PMPUnzip|x|      |      |      |       |     |     |     |      |     | .ZIP |
  553. LHext   |x|      |      |      |       |     |     |  D? |      |     |      |
  554. BSC     |c|      |   E  |      |       |     |     |     |      |     |      |
  555. Nulib   |c|   X  |      |      |       |     |     |     |      |     |      |
  556. SciiBin |c|      |   D  |      |       |     |     |     |      |     |      |
  557.  
  558. (Key:   E = Encode only,    D = Decode only,  X = Encode and Decode)
  559. (Type:  e = Apple //e,  g = GS Only,  x = GS EXE file, c = C Source code)
  560.  
  561. [1] Angel is pretty Buggy, but it's worth a try.
  562.     
  563.  
  564. ------------------------------
  565.  
  566. Date: 6/7/93
  567. From: dmag@umich.edu
  568. Subject: What do the file extensions mean?
  569.  
  570.  
  571.  Many times, people put filename extensions (extra characters at the end of a
  572.  filename) to denote what type of file it is. Please note that these are just
  573.  accepted standards. If a file does not indicate it's type, see the section on
  574.  file formats. The following is a table of some common filename extensions.
  575.  See the section on archivers for programs that will deal with these files.
  576.  
  577. Extension   What is it?  (What program do I use?)
  578. ---------  ---------------------------------------------------------------
  579.  
  580.  .aaf   [TEXT] Apple Archive Format for source code (aaf.unpacker)
  581.  .ACU   NuFX (Shrinkit)
  582.  .ARC   ARC Archive (IBM ARC, GS Shrinkit, //e Angel or DeArc2E)
  583.  .CPT   Compactor Pro archive (Compactor Pro on a Mac only)
  584.  .BSC   BinScii file. [TEXT]  (BinScii)
  585.  .BSQ   BinScii'ed NuFX file. [TEXT]  (BinScii, Shrinkit on the result)
  586.  .BXY   NuFX archive with a Binary II header.  (Shrinkit)
  587.  .BNY   BLU archive. (Shrinkit)
  588.  .BQY   NuFX with BLU header. (Shrinkit)
  589.  .BNX   NuFX with BLU header. (Shrinkit)
  590.  .exe   Executioner file [TEXT]. May only work in DOS 3.3.
  591.  .GIF   Graphics Interchange Format: Compressed picture.
  592.         (IIGIF for //e, many programs for all other computers)
  593.  .HQX   Mac BinHex file. [TEXT] (BinHex on Mac or GSCII+)
  594.  .JPG   Newer graphics format. (only Unix/IBM/etc viewers)
  595.  .JPEG  Newer graphics format. (only Unix/IBM/etc viewers)
  596.  .LZH   LZH Archive (IBM/Amiga LZH program, //e Angel)
  597.  .LHA   LHA Archive (IBM/Amiga LZH program, //e Angel)
  598.  .QQ    BLU archive.  (Shrinkit)
  599.  .SEA   Self-extracting archive (Might be Mac, Might be Shrinkit archive)
  600.  .SIT   Mac StuffIt archive. (Stuffit on Mac or GS ShrinkIt)
  601.         GS Shrinkit will not decode StuffIt Deluxe files.
  602.  .SHK   NuFX archive. (Shrinkit)
  603.  .SDK   NuFX with a shrunk disk image. (Shrinkit)
  604.  .tar   Unix Tape Archive (Unix tar [with -xvf option, GS EXE tar])
  605.  .txt   [TEXT] An ASCII text file: usually english text.
  606.  .TIFF  Graphics format (GS SHR Convert)
  607.  .uu    Unix uuencode file [TEXT] (//e uudecode, Unix uudecode)
  608.  .ZOO   IBM Zoo Archive (GS Shrinkit or IBM ZOO program, //e Angel)
  609.  .ZIP   IBM Zip Archive (GS EXE Unzip, IBM PKUNZIP, Unix unzip, //e Angel)
  610.  .Z     Compressed file (GS Shrinkit, Unix uncompress, //e Angel)
  611.  
  612.  
  613.  All of these types, except the ones marked [TEXT] are BINARY files. Binary
  614.  files cannot be sent over e-mail, posted to the newsgroups or FTP'd in text
  615.  mode. You must FTP them in binary mode (see the section on FTP). You can also
  616.  download them using kermit, X-,Y- or Z-Modem.
  617.  
  618.  Generally, anything labeled as 'Archive' above will contain multiple files,
  619.  and even subdirectories. Most archives are also in compressed format.
  620.  
  621.  Sometimes you will find multiple filename extensions. Simply take the
  622.  filename extensions apart one at a time and you should be able to reconstruct
  623.  the original file. (i.e. somefile.bsq.tar.Z would mean: uncompress, untar,
  624.  unbinscii, then unShrink to get the original file!)
  625.  
  626. ------------------------------
  627.  
  628. Date: 1/1/93
  629. From: dmag@umich.edu
  630. Subject: How do I tell what kind of file this is?
  631.  
  632.  
  633.  Here is a simple guide to help you identify a file. You should always go by
  634.  filename extension first, but not everybody uses those. In Unix, you can use
  635.  the 'head' command to look at the first couple of lines of a file. If it
  636.  turns out to be a binary file, you may be in for a surprise. You may want to
  637.  use the Unix 'file' command to find out if it is a text file or not first.
  638.  Once you have identified the file, see the section on filename extensions for
  639.  how to deal with it.
  640.  
  641.  If there are lines in the file that look like this (there can be other text
  642.  before it--search for 'FiLeStArT'):
  643.  
  644. FiLeStArTfIlEsTaRt
  645. ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz0123456789()
  646. GBINSCII        AQhmAAAAA8)4MIAI02DA9ARMQEDtAQhmAIVZ
  647. gYITA6u7xADA0MjM3YTNBlDOENkQwYURzITM2UDN5gzNDJUQGVERyEDM1QzM4cjN
  648. CFUOFR0QxAjR0MjM3YTNBlDOENkQwAQRzITM2UDN5gzNDJUQGVERyEDM1QzM4cjN
  649. ...
  650.  
  651.      then you've got something encoded by BinSCII. You must decode _all_ the
  652.  parts using BinSCII before attempting to extract using ShrinkIt.
  653.  
  654.  On the other hand, if you have a binary file which resembles:
  655.  
  656. NuFilei][![/#NuFX_<:c[[[ H`F-fGSCII~[
  657. cRJ0)fNN^P)3'A2p6SF6X#GPd<9#'LC^08N7n\NB7Dd!eMN&eYX0Am=fXp
  658. d@PAsp7rh`I'NS0ALAfi2)2ysGEQ$k9CP%L9
  659. ....
  660.      then you have a NuFX file (note the key words NuFile and NuFX). You
  661.  should be able to extract the files it contains using ShrinkIt.
  662.  
  663.  On the third hand, if you have a text file which resembles:
  664.  
  665. begin 666 nonsense.bny
  666. M4W5N3U,@4F5L96%S92 T+C$@*%-$4U0V,"D@(S@Z(%1U92!/8W0@.2 Q,CHS
  667. M...3HT.2!%1%0@,3DY, HT
  668.      then you have a uuencoded file.
  669.  
  670.  On another hand, if you have a text file which begins with
  671.  
  672. (This file must be converted with BinHex 4.0)
  673. :$&4)48C28N0&,P0*9!"6593K8dP8)3%!!!#L@!!!!!!Qie0*9#%!!3!!SPKb6'&
  674. e!3!!!!!!!!!#!!P8D'8J4QpbBf9P)IN33)(4$N#"d4K!JG%S!!!!!`!'VfJ!"VP
  675.  
  676.      then you have a BinHex file. The GSCII+ NDA by Derek Taubert decodes
  677.  BinHex files on an Apple IIGS. You can also use a variety of macintosh
  678.  programs to do the decoding. There is also a Unix implementation of BinHex
  679.  called mcvert.
  680.  
  681.  On one more hand, if you have a text file which resembles:
  682.  
  683. CALL-151
  684. E00:38 A5 FF D0 32 D8 20 8E FD AD 30 BF 8D 6A 0E 20 00 BF C7 6D 0E 0D 80 02
  685. E18:D0 1D 20 00 BF C5 69 0E B0 15 AD 81 02 29 0F AA E8 8E 80 02 A9 2F 8D 81
  686.  
  687.      and more lines like that, followed by a bunch of lines that look like:
  688.  
  689. A90885A420732090242039FB2058FCA200BD9220F00620EDFDE8D0F5200CFDA9
  690. 008DF2038DF3038DF4036CFCFFE6A4A5A4C96F90CFA9008DFCBFA9018DFDBFA0
  691. A90885A420732090242039FB2058FCA200BD9220F00620EDFDE8D0F5200CFDA9
  692.  
  693.      then you have an Executioner file.
  694.  
  695. ======================================================================
  696. This FAQ is available on-line at apple2.archive.umich.edu (see FTP)
  697. Permission granted to reproduce in non-profit User Group newsletters.
  698.  
  699. Any additions/corrections/suggestions would be appreciated.  Also,
  700. if this FAQ has helped you, e-mail me and let me know!
  701.                                         Dan DeMaggio (dmag@umich.edu)
  702.     -- 
  703.             -=- Dan DeMaggio -=- dmag@umich.edu -=-
  704. "That is really incredible. That is truly incredible.  That is so
  705. incredibly incredible that I think I'd like to steal it." -Zaphod
  706. -- 
  707.             -=- Dan DeMaggio -=- dmag@umich.edu -=-
  708. "That is really incredible. That is truly incredible.  That is so
  709. incredibly incredible that I think I'd like to steal it." -Zaphod
  710.  
  711.  
  712.